.. _cec_Get:

cec_Get
=======
-------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cec_Get(
    VT_I4 Channel,
    PDWORD Count
  )



DESCRIPTION
-----------


- 대상 카운터 채널의 카운트 값을 반환합니다



PARAMETER
---------


- Channel : 채널 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero. Based) 이상, (최대 통합 채널수 - 1) 이하의 값을 채널 번호로 설정할 수 있습니다. 

- Count : 이 매개변수를 통하여 대상 채널의 카운트 값을 반환합니다. 




RETURN VALUE
------------

+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+

EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 long nCntChNo = 1; // 카운터 채널 번호
 long nCount; // 카운트 값
 long nOverFlowState = CE_FALSE; // 대상 채널의 Overflow 상태 정보
 // 채널의 카운트 기능을 활성 상태로 설정합니다.
 cecEnableOne_Set ( nCntChNo, CE_TRUE );
 /* 대상 카운터 채널을 통해 카운트를 시작합니다.
 Overflow 가 발생하면 카운트를 멈추고 Overflow 상태를 해제합니다. */
 while ( nOverFlowState == CE_FALSE )
 {
 // 채널의 카운트 값을 반환합니다.
 if ( cec_Get ( nCntChNo, &nCount ) == ceERR_NONE )
  {
   cecOverflowFlagGetOne ( nCntChNo, &nOverFlowState );
  } 
 }
 // 카운트 채널에 Overflow 가 발생하면 while 반복문을 멈추고 Overflow 상태를 해제합니다.
 if ( cecOverflowFlagClearOne ( nCntChNo ) != ceERR_NONE )
 {
 OutputDebugString ( “cecOverflowFlagClearOne has been failed” );
 }